home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / proset.arc / PRO-SET.DOC < prev   
Encoding:
Text File  |  1988-03-24  |  22.6 KB  |  386 lines

  1.  
  2.                                    PRO-SET
  3.                    An IBM Proprinter Configuration Utility
  4.                           Version 3.5 - March 25, 1988
  5.     
  6.                                by Fred Willshaw
  7.                                  CIS 73075,321
  8.  
  9. PRO-SET is a utility program which may be used to send control strings to the
  10. IBM PROPRINTER without the necessity of exiting the program you are currently
  11. using.  It is distributed at no cost and may be freely copied and used.
  12. Should, however, you alter the program code in anyway it is forbidden to pass
  13. this program on to others.  If you would like to see modifications to the
  14. current program please contact the author.
  15.  
  16. I will attempt to keep the current version on the following Bulletin Boards in
  17. the New York/New Jersey area.  The program will be named PROSETxx.ARC where xx
  18. will indicate the latest version number.
  19.  
  20.                  Bulletin Board          Telephone#
  21.                ------------------      --------------
  22.                The POLICE              (201) 963-3115
  23.                CFONJ                   (201) 486-2956
  24.                The BOSS                (201) 568-7293
  25.                Software Society        (201) 729-7410
  26.                Invention Factory       (212) 431-1194
  27.  
  28.                            PRO-SET PARAMETERS           
  29.                            ------------------
  30.  
  31. You may either execute the program as a stand-alone DOS batch program or you
  32. may load it into resident memory.  Both modes are accomplished by placing the
  33. desired parameter(s) after the program name, then executing the program. These
  34. optional parameters are:
  35.  
  36.                     PRO-SET [R=x C=x V=x K=x S=x A=xxx]
  37.  
  38. Where R=x indicates the type run you wish to perform, the two options are:
  39.  
  40.            "R" for Load into low memory and remain resident.  The program
  41.                may be accessed by depressing the Hot-Key/Control-Key
  42.                combination you assigned, simultaneously.  This is the default.
  43.        "B" indicates that you want to run as a batch DOS job and not
  44.                remain resident.  You may also use this option even if the
  45.                program is currently resident.
  46.  
  47. Where C=x indicates the Color mode you wish to use, the two options are:
  48.  
  49.            "C" for using the IBM C/G Adapter colors. This is the default.
  50.            "N" for no colors, the NO COLORS option is primarily for users
  51.                of Amber and Green High Res monitors.
  52.             
  53.                   Note: If you are using a Monochrome Adapter the program
  54.                         will automatically detect this.
  55.  
  56. Where V=x is the Sound On/Off indicator for the program, the two options are:
  57.  
  58.            "Y" to get Sound warnings of input errors and invalid Drive/
  59.                Path/File Names during the Font Load procedure.  This is the
  60.                default.
  61.            "N" for no sound.
  62.  
  63. Where K=xx indicates the Hot-Key to be used along with the Control-Key
  64.            key(s) to activate the Memory Resident version.  Enter the
  65.            hexidecimal scan code value.  If you do not assign your own Hot-Key
  66.            PRO-SET will use the letter "P".  A partial list is shown below:
  67.  
  68.            KEY  SCAN      KEY  SCAN     KEY  SCAN     KEY  SCAN     KEY  SCAN
  69.            =========      =========     =========     =========     =========
  70.             A    1E        G    22       L    26       Q    10       V    2F
  71.             B    30        H    23       M    32       R    13       W    11
  72.             C    2E        I    17       N    31       S    1F       X    2D
  73.             D    20        J    24       O    18       T    14       Y    15
  74.             E    12        K    25       P    19 *     U    16       Z    2C
  75.             F    21                                  * = default
  76.  
  77. Where S=xx indicates the Control-Key key(s) to be used along with the
  78.            Hot-Key to activate the Memory Resident Version.  The default used
  79.            by PRO-SET is the <CTRL><ALT> combination. Enter the hexidecimal
  80.            total value from the following table, always enter as a two digit
  81.            value:
  82.  
  83.                   KEY       VALUE TO ADD       EXAMPLE (using the Default)
  84.               ===========   ============       ===========================
  85.               Right Shift        01                           CTRL  04
  86.               Left Shift         02                           ALT   08 
  87.               CTRL               04                                 ==
  88.               ALT                08                Enter total -->  0C
  89.  
  90. Where A=xxx indicates the drive, path and file name of the file you wish
  91.             loaded as the return address, this is optional.  Construct the
  92.             file using COPY CON: XXX, or any commonly used ASCII file editor,
  93.             with 1 to 4 lines of up to 33 characters each.
  94.  
  95.                    Example parameter:   A=C:\SUB1\SUB2\RETURN.DAT
  96.   
  97.                             Installing Pro-set
  98.                             ------------------
  99.  
  100. In order to install the program, have PRO-SET.COM in the root library or a
  101. sub-directory in the PATH command. Then include the line PRO-SET, along with
  102. your parameter(s), if any, in your AUTOEXEC.BAT file or issue the DOS command
  103. PRO-SET with your requested parameter(s), if any.
  104.  
  105. When loaded as memory resident, you may gain access to the program from any
  106. other program by depressing the Hot-Key/Control-Key combination.  The program
  107. will then intercept the keyboard interrupt (09H) and display the program menu.
  108.  
  109.                              The Program Menu's
  110.                              ------------------
  111.  
  112. Depressing the appropriate key(s) will send the appropriate character string
  113. and highlight the option on the menu or present a sub-menu for additional input.
  114. Depressing the <ESC> key will return you to the Original Program, Pro-Set Main
  115. Menu or DOS as appropriate.
  116.  
  117. The first line, [1] LPT1: -- 3:, is used to indicate which line printer port
  118. you want the control information send to.  The default is LPT1:.  If the port
  119. selected is not ready an error message will be displayed.
  120.  
  121. OPTION    COMMAND FUNCTION                    WHAT HAPPENS
  122. ------  --------------------  --------------------------------------------
  123. [A]     Set Condensed Mode    Sends <ESC> 15
  124. [B]     Stop Condensed Mode   Sends <ESC> 18
  125. [C]     Set 12 CPI            Sends <ESC> 58
  126. [D]     Set Emphasized Mode   Sends <ESC> 69
  127. [E]     Stop Emphasized Mode  Sends <ESC> 70
  128. [F]     ONE Direction Print   Sends <ESC> 85 01
  129. [G]     TWO Direction Print   Sends <ESC> 85 00
  130. [H]     Set Double Wide       Sends <ESC> 87 01
  131. [I]     Stop Double Wide      Sends <ESC> 87 00
  132. [J]     Character Set 1       Sends <ESC> 55
  133. [K]     Character Set 2       Sends <ESC> 54 02
  134. [L]     Format/Reset/Envelope Displays sub-menu
  135.  
  136.    [A]  Reset Printer         Sends 24             Empty Buffer
  137.                                     18             Cancel Condensed/Set 10 CPI
  138.                                     <ESC> 45 00       Cancel Underscore
  139.                                     <ESC> 53 00    Cancel Auto Linefeed
  140.                                     <ESC> 55       Select Character Set 1
  141.                                     <ESC> 61 00 00 Clear Download Buffer
  142.                                     <ESC> 65 12    6 Lines to Inch
  143.                                     <ESC> 67 66    Set 66 Lines to Page
  144.                                     <ESC> 67 00 11 Set to 11 Inches to Page
  145.                                     <ESC> 70       Cancel Emphasized Print
  146.                                     <ESC> 72       Cancel Doublestrike
  147.                                     <ESC> 73 00    Standard Print Mode
  148.                                     <ESC> 79       Cancel Automatic Perf Skip                    
  149.                                     <ESC> 82       Cancel Tab Settings
  150.                                     <ESC> 84       Cancel Sub/Superscript
  151.                                     <ESC> 85 02    Set Bidirectional Print
  152.                                     <ESC> 87 00    Cancel Double Wide Print
  153.                                     <ESC> 95 00    Cancel Overscore
  154.    [B]  Set Top of Form       Sends <ESC> 04
  155.    [C]  Form Length (Inches)  Sends <ESC> 12 00 ##    (Where ## is the value
  156.    [D]  Form Length (Lines)   Sends <ESC> 12 ##            you entered)
  157.    [E]  Print an Envelope     Displays input screens
  158.  
  159.                                  Enter up to four lines of 33 characters for
  160.                                  a return address, depress the <ENTER> key
  161.             Return Address       after each line even if there is no entry.
  162.                                  Pressing <ESC> will return you to the Main
  163.                                  Menu.  The return address entered will be
  164.                                  stored and displayed the next time you enter
  165.                                  this function.  If you have no changes,
  166.                                  depress the <ENTER> key four (4) times.  You
  167.                                  may also preload a return address using the
  168.                                  initial paramters outlined above (A=).
  169.  
  170.                                  Enter up to four lines of 33 characters for
  171.                                  a mailing address, depress the <ENTER. key
  172.             Mailing Address      after each line even if there is no entry.
  173.                                  Pressing <ESC> will return you to the Main
  174.                                  Menu.
  175.  
  176.                                  Next, insert an envelope into the printer,
  177.                                  see directions below if not certain, then
  178.             Select Size          select the envelope size type by depressing
  179.                                  the appropriate size type - F1=Standard Size
  180.                                  F2=Legal Size or <ESC> to return to the Main
  181.                                  Menu.
  182.  
  183.                                  Proper placement of the envelope into the
  184.                                  Proprinter - Slide the envelope face up,
  185.             Positioning          top first and left side against the 
  186.                                  LEFT EDGE GUIDE, see manual page 1-10 bottom,
  187.                                  into the FRONT OPENING until you feel the
  188.                                  envelope stop moving.  At this point you are
  189.                                  ready for PRO-SET to print your envelope.
  190.  
  191. [M]     1/8" Spacing          Sends <ESC> 48
  192. [N]     7/72" Spacing         Sends <ESC> 49
  193. [O]     Set Normal Quality    Sends <ESC> 73 00
  194. [P]     Set Normal Download   Sends <ESC> 73 04
  195. [Q]     Set NLQ Normal        Sends <ESC> 73 02
  196. [R]     Set NLQ Download      Sends <ESC> 73 06
  197. [S]     Set NLQ Doublestrike  Sends <ESC> 71
  198. [T]     Stop NLQ Doublestrike Sends <ESC> 72
  199. [U]     Font Processing       Displays sub-menu
  200.  
  201.    [1]  FONTGEN Created       Indicates that file to be downloaded was
  202.                               created by the FONTGEN program. The next sub-menu
  203.                               is then displayed with which you indicate the
  204.                               Drive/Path/Data Set Name of the file to be
  205.                               downloaded.  After completion of this sub-menu
  206.                               the file is downloaded to the active printer.
  207.    [2]  IBM Format            Indicates that file to be downloaded was
  208.                               created to appear as in the IBM Proprinter Manual.
  209.                               The next sub-menu is then displayed with which
  210.                               you indicate the Drive/Path/Data Set Name of the
  211.                               file to be downloaded.  After completion of this
  212.                               sub-menu the file is downloaded to the active
  213.                               printer.
  214.    [3]  Create a Character    Indicates that you wish to construct a download
  215.                               character of your own.  The subsequent input
  216.                               screen is processed as follows:
  217.         Char Code =           Enter the character code to be downloaded in the
  218.                               range decimal 33 to 126.
  219.         Attribute =           Indicate the ascend/decender code 0 or 1
  220.         <arrow keys>          Move around the grid with the arrow keys, they
  221.                               will automatically wrap-around.
  222.         <ENTER>               Depressing <ENTER> will reverse the pin printing
  223.                               by toggling this pin position On or Off.
  224.         F1 = Download         Depressing the <F1> key will download the
  225.                               character to the active printer.
  226.         F2 = Save to file     Depressing F2 will display a sub-menu with which
  227.                               you indicate the Drive/Path/Data Set Name of the
  228.                               file the character is to be saved in.  If the
  229.                               file exists, the character will be added to the
  230.                               end of the file, if not, a new file will be
  231.                               created.  This file may be subsequently down-
  232.                               loaded using the IBM file format download option.
  233.         F3 = Clear            Depressing <F3> will clear the pin map,
  234.                               character code and attibute from the input screen.
  235.         <ESC>                 Escape will return you to the Primary Menu. 
  236.  
  237.                             >>>>>>>>>>>> IMPORTANT NOTE <<<<<<<<<<<<<<<
  238.                          After you have downloaded a font file you must
  239.                          instruct the printer how to process the downloaded
  240.                          font be using either option <P> SET NORMAL DOWNLOAD
  241.                          or <R> SET NLQ DOWNLOAD.  Selection of the <U> option
  242.                          does NOT establish the mode you wish to print in.
  243.                          It should also be noted that if you download a single
  244.                          character to the buffer only that character code will
  245.                          print for character codes in the decimal 33 to 126
  246.                          range.
  247.  
  248. [V]     Typewriter Mode       Displays work area of 66 lines by 80 columns
  249.                               into which you may enter data to be printed on
  250.                               the Proprinter.  This is a not a full function
  251.                               word processor, it is intended for quick and
  252.                               fast generation of hard copy output.  Most
  253.                               cursor controls work along with an insert mode.
  254.  
  255.         F1=Print             Depressing F1 will print the work area of 66
  256.                              lines by 80 columns to the active printer.
  257.         F2=Clear             Depressing F2 will clear the work area.
  258.         <ESC> Quit           Return to the main menu.
  259.  
  260.                              IT WON'T WORK WITH
  261.                              ------------------
  262.  
  263. PRO-SET will not execute, and will lock up, on a any machine using the IBM
  264. 3270 Work Station Control program series.  The Control Program simply doesn't
  265. care for other programs taking over interrupts.  Not a friendly program at all.
  266. PRO-SET will run properly with the Control Program in batch (R=B) mode.
  267. Comments were received that PRO-SET does not function with DOS 3.3, however,
  268. that is what I am currently using and the program functions normally.
  269.  
  270. If you have problems in making PRO-SET function properly, a careful examination
  271. of the memory resident programs you are using may be in order.  Certain
  272. combinations and sequences may cause improper execution of PRO-SET or your
  273. other programs.  Try loading these programs in a different sequence until they
  274. produce the proper results.  A leading offender with PRO-SET are Print Spoolers
  275. and Keyboard Enhancers.
  276.  
  277.                       UPDATES/MODIFICATIONS/CORRECTIONS
  278.                       ---------------------------------
  279.  
  280. Version 1.1 (01/07/86) - Added support for graphics modes 320X200 and
  281.                          640X200.  Note that this is determined by BIOS
  282.                          Interrupt 10H.  Some programs do not properly
  283.                          set this value, i.e. 1-2-3 in Graphics mode.
  284.                          Since the configuration screen cannot fit in 40
  285.                          column modes, a beep will sound if you attempt
  286.                          to use the program in 40 column mode.
  287.  
  288. Version 2.0 (01/21/86) - Added support for download fonts.  Depressing
  289.                          option U will present a sub-menu requesting the
  290.                          download font file format.  The first FONTGEN,
  291.                          is created using the FONTGEN utilities found
  292.                          on many Bulletin Boards.  It is well worth the
  293.                          download to get a copy of this program series.
  294.                          The second file format is the IBM standard
  295.                          layout as described in the PROPRINTER Manual.
  296.                          Another sub-menu will be displayed requesting
  297.                          the location and name of the font file to be
  298.                          loaded.
  299.                          A new sub-menu has taken the place of TOP
  300.                          OF FORM.  This is option L and will present a
  301.                          sub-menu offering TOP OF FORM, Form length in
  302.                          inches, Form length in lines and a Reset of the
  303.                          printer.  The Reset is taken from the Technical
  304.                          Reference Manual and issues an interrupt 17H
  305.                          with AH set to a 1.  This option does not seem
  306.                          to work on my Proprinter and as there is no
  307.                          discussion in the Proprinter Manual of such a
  308.                          feature, your helpful assistance is requested.
  309.                          When changing the LPTx: option the selected
  310.                          printer is now checked to ensure that it is
  311.                          online.  If the printer is not available, i.e.,
  312.                          turned off or offline, the program will notify
  313.                          you when selecting the printer.  However, if
  314.                          you are sending a command string and the printer
  315.                          is unavailable, the program will sit patiently
  316.                          and wait for you to turn on the device.
  317.  
  318. Version 2.1 (01/27/86) - Moved save of current path, FCB and DTA to Font
  319.                          routine in order to speed up execution for 
  320.                          non-font requests.
  321.  
  322. Version 3.0 (02/21/86) - Added ability to run as a batch program.  Allowed
  323.                          selection for color or black/white for users of
  324.                          amber/green high res screens.  Rewrote documentation.
  325.                          Added screen to show how parameters are entered in
  326.                          the event they are incorrectly entered. Converted
  327.                          all DOS Interrupt (21H) calls to ROM BIOS calls
  328.                          as the DOS calls were destroying the DOS stack
  329.                          when called from a resident program.  See the small
  330.                          print in the DOS manual !  Added ability to turn
  331.                          sound on and off.  Fixed cursor mode on Monochrome.
  332.                          Added ability to select the Hot-Key Combination to
  333.                          activate the memory resident version.  Gave ability
  334.                          to run as a DOS batch program.  Changed Printer
  335.                          Reset routine to pass individual parameters.  Added
  336.                          ability to set the internal drive table to specific
  337.                          configuration requirements.
  338.  
  339. Version 3.1 (03/04/86) - Added code to determine 12 or 16 bit fat based on the
  340.                          cluster size comments on page 122 of Peter Noton's
  341.                          book PROGRAMMER'S GUIDE TO THE IBM PC (c) 1985. Fixed
  342.                          problem where initial address of LPT1: was hard coded
  343.                          and not from printer base table.  Added routine to
  344.                          print envelopes while in PRO-SET.  Routine supports
  345.                          Standard and Legal size envelopes.  Many thanks to
  346.                          Ed Feins of CFONJ for putting up with my feeble
  347.                          attempts at programming and making this update
  348.                          possible.
  349.  
  350. Version 3.2 (03/11/86) - Deleted all references to BIOS routines, now using
  351.                          Interrupt 21H functions 3D, 3E and 3F.  This
  352.                          includes the drive location table parameter (D=)
  353.                          which was removed.  Added ability to preload a return
  354.                          address via the parameters, see A=.  While the BIOS
  355.                          routine worked fine on Floppies and 10 Meg hard disks,
  356.                          it had serious problems with DOS 3.1 and hard disks
  357.                          in the 16 bit FAT category.  If and when decent
  358.                          documentation is available on these problems BIOS
  359.                          may reenter the PRO-SET world.  Again thanks to
  360.                          Ed Feins and Eric Rintell for their cooperation and
  361.                          spirit of adventure !
  362.  
  363. Version 3.3 (04/07/86) - Added ability to create, download and/or save
  364.                          font characters you have created.  Fixed bug in
  365.                          data set processing of drives other than current
  366.                          drive.  Tested the INIT line reset technique shown
  367.                          in the current issue of PC Tech Journal for reset
  368.                          of the Proprinter.  Since it does not do a complete
  369.                          reset the previous routine was retained.
  370.  
  371. Version 3.4 (05/02/86) - Added a typewriter mode for entering and printing
  372.                          a page of output.
  373.  
  374.  
  375. Version 3.5 (03/25/88) - Added cancel of automatic perforation skip to
  376.                          Reset function.  Corrected bug in descender which
  377.                          manual incorrectly describes.  Many thanks to those
  378.                          of you who took the time to drop a comment on my
  379.                          efforts.  This is the last release, as I don't
  380.                          use the program myself anymore.  The assembler
  381.                          source is included for those of you who want to
  382.                          have some fun !  If you make any changes please
  383.                          remove my name before distributing to anyone.
  384.              Note that PRO-SET was created using the PHOENIX
  385.              software packages PMATE, PASM86 and PLINK86 plus.
  386.